📝 Docs

• Did you update the CHANGELOG.md?

📲 What

Introduces group detection ("Highlight active riders") plus a "What's New" onboarding sheet, consolidates Observation Mode, and adds a local development environment.

Highlight active riders (group detection)

• Detects riders travelling together and highlights them on the map; riders outside a group stay visible but de-emphasized.
• Rider dots now have three clear states (RiderAnnotationView):
  • Highlighting off → all riders neutral (.label), full size
  • Highlighting on, in a group → brand color, full size
  • Highlighting on, not in a group → gray, shrunk
• New Highlight active riders toggle in Settings (userSettings.highlightActiveRiders).
• Fixes a bug where new annotations showed the wrong color until the next fetch — the map coordinator's parent snapshot wasn't refreshed in updateUIView.

"What's New" sheet

• Shown once per user — on every fresh install (onboarding) and when updating to the announced release (AppFeature.whatsNewVersion), gated by lastSeenWhatsNewVersion and an injectable appVersion dependency.
• Lets users toggle Highlight active riders and Observation Mode directly, with a live hero image that previews the highlight on/off.

Observation Mode consolidation

• Removed the launch-time observation-mode alert (and its Destination.alert plumbing + didShowObservationModePrompt); the toggle now lives in the What's New sheet and Settings.
• Corrected the copy: Observation Mode is for people following a ride without taking part (passengers, drivers, onlookers) so their location isn't shared as a rider.

Styleguide

• CMButtonStyle now uses a tinted, interactive Liquid Glass capsule on iOS 26 (solid brand fill below) and a more prominent font.

Local development environment

• A Critical Maps (Local) scheme / Debug Local build configuration points the app at a local mock server via an injectable ServerConfiguration (host/scheme/port + poll interval); production is the untouched default. ATS exception added for localhost. (The mock server itself lives in a separate repo.)

Localization & tests

• New/updated strings across all 9 locales (regenerated L10n.swift).
• Added/updated tests: RiderActivityFilterTests, RiderAnnotationUpdateClientTests, and AppFeatureTests (What's New gating).

🤔 Why

• On a busy map it's hard to tell where actual groups are versus stray/solo riders — highlighting groups makes the ride legible.
• These opt-in features were only discoverable in Settings; the What's New sheet surfaces them on install/update.
• The old observation-mode alert was intrusive and its copy was misleading; folding the toggle into the sheet (and fixing the wording) is clearer and keeps non-participants from being counted as riders.
• We needed to develop the live map against realistic ride data without depending on the production API.

👀 See

♿️ Accessibility

• Works with VoiceOver
• Supports Dynamic Type

Already handled: feature toggles use system Toggle (each keeps its localized title as the VoiceOver label via labelsHidden); text uses Dynamic Type system fonts; the hero image is accessibilityHidden; rider dot colors use dynamic system colors (.label/.systemGray) so they adapt to light/dark. Please verify VoiceOver/Dynamic Type on device before ticking.